src/main/java/inha/gdgoc/domain/recruit/dto/request/PaymentUpdateRequest.java (1)

3-5: 네이밍 정합성: isPayed → isPaid/paid 권장 (영문 철자 개선, API 가독성 향상)

도메인 전반에 isPayed가 이미 사용 중인 점은 이해하지만, 공개 API 필드로 계속 노출하면 장기적으로 혼란을 유발합니다. 점진적 마이그레이션을 제안합니다: 요청 DTO는 paid를 노출하고 @JsonAlias("isPayed")로 하위 호환 유지, 응답 DTO에도 동일 패턴 적용.

원하시면 전체 레포에서 isPayed 참조를 수집하고 변경 영향도를 리포트하는 스크립트를 제공하겠습니다.

src/main/java/inha/gdgoc/domain/recruit/enums/AdmissionSemester.java (1)

3-5: 열거형 고정 대신 값 객체/문자열 저장 고려

매 해마다 enum 상수를 추가해야 하는 운영 부담이 큽니다. DB는 VARCHAR로 저장 중이므로, 자바 측도 enum 대신 Year-Semester 값 객체(예: record YearSemester(int year, int term)) 또는 검증된 문자열을 사용하는 방안도 검토해 보세요.

src/main/java/inha/gdgoc/global/util/SemesterCalculator.java (3)

13-16: 열거 미존재 시 예외 타입 및 메시지 개선, 운영 가드 필요

현재는 모든 예외를 묶어 RuntimeException으로 재던집니다. 상태 불일치에 가까우므로 IllegalStateException이 더 적절합니다. 또한 “다음 해 상수 추가 필요”를 명확히 표기하고, 로그/모니터링에서 탐지 가능하도록 에러 코드를 포함하세요.

-        try {
-            return AdmissionSemester.valueOf(enumName);
-        } catch (Exception ex) {
-            throw new RuntimeException(
-                    "AdmissionSemester enum에 상수 " + enumName + " 이(가) 정의되어 있지 않습니다. " +
-                            "해당 연도/학기 상수를 추가하세요.", ex
-            );
-        }
+        try {
+            return AdmissionSemester.valueOf(enumName);
+        } catch (IllegalArgumentException ex) {
+            throw new IllegalStateException(
+                    "[SEMESTER_ENUM_MISSING] AdmissionSemester에 " + enumName +
+                    " 상수가 없습니다. 다음 해/학기 상수를 선반영하세요.", ex
+            );
+        }

Also applies to: 35-43

---

24-33: 2월(02) 처리 도메인 검증 필요: 현재 로직은 2월을 ‘해당 연도 1학기’로 산정

국내 학사 캘린더 기준으로 2월은 방학(전년도 2학기)에 귀속시키는 경우가 많습니다. 의도된 비즈니스 규칙인지 확인이 필요합니다. 규칙이 다르면 분기 조건을 조정하고 경계 월(1/2/3/8)의 회귀 테스트를 추가하세요.

원하시면 경계 날짜(01-31, 02-01, 03-01, 07-31, 08-01, 12-31)에 대한 파라미터라이즈드 테스트 템플릿을 제공하겠습니다.

---

21-23: 연산 안전성(가독성) 개선 여지

yy = (year - 1) % 100 대신 Math.floorMod(year - 1, 100) 사용을 고려하면 음수 연도 입력 등 엣지 케이스에서 더 안전합니다(의미상 큰 차이는 없으나 명확성 향상).

src/main/java/inha/gdgoc/domain/recruit/dto/request/RecruitMemberRequest.java (2)

29-29: 요청 DTO에 isPayed 노출은 혼란 유발: 생성 시 항상 false로 고정됨

toEntity()에서 .isPayed(false)로 강제되므로 클라이언트가 값을 보내도 무시됩니다. 생성 API에서 결제 상태를 받지 않는다면, 필드를 제거하거나 역직렬화 불가로 처리해 혼동을 줄이세요.

두 가지 대안:

• 아예 필드 제거
• 역직렬화 차단

+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonProperty.Access;
 ...
-    private Boolean isPayed;
+    @JsonProperty(access = Access.READ_ONLY)
+    private Boolean isPayed;

---

45-46: 현재 학기 자동 지정은 합리적이나, enum 범위 누락 시 런타임 예외 전파 가능

SemesterCalculator.currentSemester()가 enum 미존재로 실패하면 신규 지원 생성 자체가 막힙니다. 상수 선반영(AdmissionSemester.java 코멘트 참조) 또는 컨트롤러/서비스에서 예외 메시지를 사용자 친화적으로 매핑하세요.

src/main/java/inha/gdgoc/domain/recruit/repository/RecruitMemberRepository.java (1)

11-11: 이름 부분검색 페이징 메서드 추가: 사용성 측면에서 LGTM

메서드 시그니처와 반환 타입(Page)이 적절합니다. 다만 대용량 데이터에서 ContainingIgnoreCase는 함수적 인덱스를 타지 못할 수 있어(LOWER(name) 사용) 성능 이슈가 생길 수 있습니다. DB에 따라 함수 인덱스/CI(T)EXT/대소문자 무시 컬레이션 등을 검토하세요.

성능 개선용 인덱스 예시(PostgreSQL):

CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_recruit_member_name_lower
ON recruit_member (LOWER(name));

src/main/resources/db/migration/V20250826__admission_semester_add_backfill_enforce.sql (3)

6-15: 백필 로직의 경계월/타임존/NULL 위험 — NOT NULL 전환 시 장애 가능성

• 1월을 전년도 2학기로 매핑하는 규칙과 27/812 경계가 비즈니스 규칙과 정확히 일치하는지 확인 필요.
• created_at 컬럼이 UTC라면 학기 경계(특히 1월/8월 초)에서 오분류 가능성 있음. KST 기준이 요구된다면 EXTRACT 전에 AT TIME ZONE 'Asia/Seoul' 고려.
• created_at가 NULL인 레코드가 존재하면 UPDATE 후에도 admission_semester가 NULL로 남아 SET NOT NULL 단계에서 실패합니다.

사전 점검 쿼리 제안:

• SELECT COUNT(*) FROM recruit_member WHERE created_at IS NULL;
• SELECT EXTRACT(MONTH FROM created_at) AS m, COUNT(*) FROM recruit_member GROUP BY m ORDER BY m;

주석 가독성도 개선해두면 좋습니다. 예시 diff:

- -- 학기 규칙: 2~7월 = YYY_1, 8~12월 = YYY_2, 1월 = (전년도) YYY_2
+ -- 학기 규칙(KST 가정): 2~7월 = YY_1, 8~12월 = YY_2, 1월 = (전년도) YY_2
+ -- 예시: 2025-03 ⇒ Y25_1, 2025-10 ⇒ Y25_2, 2025-01 ⇒ Y24_2

---

19-20: NOT NULL 전환 전 사전 검증/보정 절차 필요

SET NOT NULL는 남아있는 NULL을 즉시 실패시킵니다. 마이그레이션 안정성을 위해:

• (권장) 백필 후 잔존 NULL 개수 점검 및 실패 시 롤백/중단.
• (대안) created_at NULL 레코드에 대한 보정 규칙 명시(예: 현재 학기 적용 또는 수동 처리 리스트 작성).

NULL 잔존 점검 쿼리:

• SELECT COUNT(*) FROM recruit_member WHERE admission_semester IS NULL;

---

23-24: 대용량 운영 테이블 고려 시 인덱스 락 완화 권고

운영 데이터가 많다면 CREATE INDEX가 테이블에 공유락을 유발할 수 있습니다. PostgreSQL이라면 CONCURRENTLY 옵션을 고려하세요. 단, Flyway SQL 마이그레이션은 트랜잭션 안에서 실행되므로 CONCURRENTLY 사용 시 해당 마이그레이션을 non-transactional로 분리해야 합니다.

적용 예시(별도 non-Tx 마이그레이션으로 분리 권장):

-CREATE INDEX idx_recruit_member_admission_semester
-    ON recruit_member (admission_semester);
+-- 대용량 환경에서는 다음과 같이 CONCURRENTLY 사용을 검토하세요 (트랜잭션 밖에서 실행 필요).
+CREATE INDEX CONCURRENTLY idx_recruit_member_admission_semester
+    ON recruit_member (admission_semester);

src/main/java/inha/gdgoc/domain/recruit/controller/message/RecruitMemberMessage.java (1)

8-10: 용어 일관성(입금/결제, 완료/미완료) 점검 제안

도메인 전반에서 payment/deposit, paid/unpaid 표현 혼재 가능성이 있습니다. 메시지/필드명/엔드포인트 응답 문구의 용어를 한 번에 정리하면 유지보수성이 좋아집니다. 예: PAYMENT_STATUS_UPDATE_SUCCESS처럼 상태 업데이트 메시지로 일반화.

src/main/java/inha/gdgoc/domain/recruit/entity/RecruitMember.java (1)

74-76: isPayed 명명 관련 사소한 컨벤션 제안

영문 관례상 paid가 맞춤법에 부합합니다. 도메인 전반에서 isPayed가 널리 사용 중이면 유지가 합리적이지만, 향후 마이그레이션 여지가 있다면 isPaid로 정리하는 것을 권장합니다.

src/main/java/inha/gdgoc/global/dto/response/PageMeta.java (1)

18-37: 정렬 메타 계산 로직 개선: 불필요한 reduce 제거 및 UNSORTED 정확히 표현

• 여러 정렬 키를 연결할 때는 reduce 대신 Collectors.joining 사용이 간단하고 안전합니다.
• 정렬이 지정되지 않은 경우에도 현재 코드는 "createdAt/DESC"를 임의 기본값으로 노출합니다. 실제 정렬이 UNSORTED라면 null(or 빈 문자열)로 표현하는 편이 정확합니다.

적용 예시 diff:

+import java.util.stream.Collectors;
@@
-        String sortProps = page.getSort().stream()
-                .map(Sort.Order::getProperty)
-                .reduce((a, b) -> a + "," + b)
-                .orElse("createdAt");
+        String sortProps = page.getSort().isSorted()
+                ? page.getSort().stream()
+                    .map(Sort.Order::getProperty)
+                    .collect(Collectors.joining(","))
+                : null;
@@
-        String dir = page.getSort().stream()
-                .findFirst()
-                .map(o -> o.getDirection().name())
-                .orElse("DESC");
+        String dir = page.getSort().isSorted()
+                ? page.getSort().stream()
+                    .findFirst()
+                    .map(o -> o.getDirection().name())
+                    .orElse(null)
+                : null;

src/main/java/inha/gdgoc/domain/recruit/dto/response/RecruitMemberSummaryResponse.java (2)

16-21: 학기 표시 문자열 포맷 책임의 위치 이동 권고

현재 포맷("Y25_1" → "25-1")을 DTO에서 substring/replace로 직접 가공하고 있습니다. 이는 enum/값객체의 표현 규칙이 바뀔 때 DTO마다 수정이 필요해 응집도가 떨어집니다. AdmissionSemester(또는 값객체)에 displayCode()/toDisplay()를 두고 DTO에서는 그 메서드를 호출하는 구조가 바람직합니다.

(전제: enum 유지 시) 사용 예시:

-            String enumName = recruitMember.getAdmissionSemester().name();
-            semester = enumName.substring(1).replace('_', '-');
+            semester = recruitMember.getAdmissionSemester().toDisplay(); // 예: "25-1"

AdmissionSemester에 추가(참고용):

public enum AdmissionSemester {
    Y25_1, Y25_2, Y26_1, Y26_2; // … 확장 또는 값객체 전환

    public String toDisplay() {
        String n = name();          // "Y25_1"
        return n.substring(1).replace('_','-'); // "25-1"
    }
}

---

22-30: Boolean null 안전성 재확인(사소)

엔티티에서 isPayed는 nullable=false이므로 현재 매핑은 안전합니다. 다만 과거 데이터 이행 도중 null 가능성이 있었다면 Boolean.TRUE.equals(...) 패턴(다른 DTO에 이미 사용됨)을 통일적으로 쓰는 것도 방법입니다.

src/main/java/inha/gdgoc/domain/recruit/service/RecruitMemberService.java (3)

75-77: 엔티티 미존재 시 도메인 예외로 통일 권장

동일 클래스의 findSpecifiedMember는 RecruitMemberException(RECRUIT_MEMBER_NOT_FOUND)를 사용합니다. 여기서만 IllegalArgumentException을 던지면 전역 예외 처리 및 응답 포맷이 불일치할 수 있습니다. 도메인 예외로 통일하는 것을 권장합니다.

적용 예시(diff):

-        RecruitMember m = recruitMemberRepository.findById(memberId)
-                .orElseThrow(() -> new IllegalArgumentException("RecruitMember not found: " + memberId));
+        RecruitMember m = recruitMemberRepository.findById(memberId)
+                .orElseThrow(() -> new RecruitMemberException(RECRUIT_MEMBER_NOT_FOUND));

---

74-74: 이름 표기 isPayed vs isPaid

도메인 전반에서 isPayed를 사용하고 있는데, 일반적으로는 paid 철자를 씁니다. 지금 PR에서의 리네이밍은 영향도가 크니 보류하되, 추후 마이그레이션 계획(필드/칼럼명 동시 변경)을 고려해 보세요.

팀 컨벤션에 따라 그대로 유지할지, 다음 릴리스에서 리네이밍할지 결정이 필요합니다.

---

85-93: 페이지 조회 메서드 구성은 적절합니다 + 클래스 레벨 readOnly 기본값 제안

읽기 전용 트랜잭션으로 잘 선언되었습니다. 서비스 클래스 레벨에 @Transactional(readOnly = true)를 두고, 쓰기 메서드(addRecruitMember, updatePayment)만 @Transactional로 override하면 가독성과 안전성이 올라갑니다. StudyAttendeeService와도 스타일이 일치합니다.

src/main/java/inha/gdgoc/domain/recruit/controller/RecruitMemberController.java (1)

98-118: 입금 상태 변경 API: 요청 유효성 검증(@Valid) 추가 및 no-op 응답 명확화 제안

• DTO 제약이 있어도 @Valid가 없으면 검증이 트리거되지 않습니다. @Valid 추가를 권장합니다.
• 현재는 요청 상태와 동일한 상태여도(서비스의 멱등 스킵) “변경했습니다” 메시지를 반환합니다. 실제 변경 여부를 반영하거나, 멱등 스킵 시 별도 메시지를 주는 방안 검토를 권장합니다.

적용 예시(diff):

-            @RequestBody PaymentUpdateRequest paymentUpdateRequest
+            @Valid @RequestBody PaymentUpdateRequest paymentUpdateRequest

추가 import:

// 추가 import 필요
import jakarta.validation.Valid;

옵션:

• 응답 본문에 최종 상태를 포함시키면(예: { "payed": true }) 클라이언트가 멱등/실변경을 쉽게 구분할 수 있습니다.
• 서비스에서 도메인 예외를 일관되게 던지도록 정리하면(현재 IllegalArgumentException 혼재) 에러 응답 표준화에 도움이 됩니다.

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

💡 Knowledge Base configuration:

• MCP integration is disabled by default for public repositories
• Jira integration is disabled by default for public repositories
• Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.